.. highlightlang:: us

.. index:: @f{3dlegend}

.. _@f{3dlegend}:

@f{3dlegend}
============

.. us.tag  @f{3dlegend} GERMAN fieldfunction Changed5600

Erzeugt eine Legende für 3D-Datensätze.

.. function::  @f{3dlegend}
    @f{3dlegend(ssDiaName)}
    @f{3dlegend(ssDiaName, ssParameter)}
    @f{3dlegend(ssParameter)}

.. us.params

**Parameter**

**Parameters**

.. uparam:: DiagramName

   *DiagramName* ist der Diagrammname des Diagramms, das die Datensätze enthält.
   Falls die Legende dem entsprechenden Diagramm zugefügt wurde, muss kein 
   Diagrammname angegeben werden.

.. uparam:: ssParameter

   Ist ein Text, der die anzuzeigenden Informationen festlegt. 

   Der Text kann einer der folgenden Texte sein:

   .. list-table::
      :header-rows: 1

      * - Text
        - Description
      * - Standard
        - Liniensymbol mit Info-Text des Datensatzes
      * - ZName
        - Z-Kanalname
      * - ZName.Unit
        - Z-Kanalname und Einheit
      * - Linesymbol.ZName.Unit
        - Liniensymbol mit Z-Kanalname und Einheit
      * - Linesymbol.Filename.ZName.Unit
        - Liniensymbol mit Dateiname, Z-Kanalname und Einheit
      * - Linesymbol.ZAxisTitle
        - Liniensymbom mit Z-Achsentitel
      * - ZAxisTitle
        - Z-Achsentitel

.. us.comment

**Kommentar**

Die Legende wird aktualisiert, wenn sich der Text oder Datensatzstil
eines Datensatzes ändert und wenn Datensätze zugefügt oder entfernt werden.

Falls der Legendentext eines Datensatzes mit einem Ausrufungszeichen "!" beginnt,
wird der Datensatz nicht in die Legende eingetragen. 

.. us.example

**Beispiel**

``@f{3dlegend(standard)}``

Die Textobjekte mit der Feldfunktion können Sie mit dem Befehl
:ref:`diagrammweitere-diagramm-funktionenlegende-fur-2d-datensatze-erzeugen` in
das Dokument einfügen. Soll die Feldfunktion nicht alle Diagramme
berücksichtigen, können Sie aus der Parameterliste der Feldfunktion die
entsprechenden Diagrammnamen entfernen.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2014.0
     - Dokumentation zugefügt.

.. seealso::
   :ref:`uberblick-feldfunktionen`,
   :ref:`bearbeitenfelder-aktualisieren`,
   :ref:`diagrammfeldfunktion-einfugen`,
   :ref:`dateialias-tabelle-bearbeiten`

:sub:`id-1548101`